From: Stefan Kangas <stefankangas@gmail.com>
Date: Fri, 28 Feb 2025 04:21:48 +0000 (+0100)
Subject: Recommend secure-hash in md5 docstring
X-Git-Tag: archive/raspbian/1%30.2+1-2+rpi1^2~2^2~24^2~257
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/success/%22http:/www.example.com/cgi/success?a=commitdiff_plain;h=6f5c322f5974786290b1b3e68b5a0685ddec3410;p=emacs.git

Recommend secure-hash in md5 docstring

* src/fns.c (Fmd5): Repeat explanation from manual about md5 being
"semi-obsolete", and recommend using secure-hash instead.
---

diff --git a/src/fns.c b/src/fns.c
index a37c651c793..8444a9edb00 100644
--- a/src/fns.c
+++ b/src/fns.c
@@ -6385,6 +6385,11 @@ command `prefer-coding-system') is used.
 If NOERROR is non-nil, silently assume the `raw-text' coding if the
 guesswork fails.  Normally, an error is signaled in such case.
 
+This function is semi-obsolete, since for most purposes it is equivalent
+to calling `secure-hash` with the symbol `md5' as the ALGORITHM
+argument.  The OBJECT, START and END arguments have the same meanings as
+in `secure-hash'.
+
 Note that MD5 is not collision resistant and should not be used for
 anything security-related.  See `secure-hash' for alternatives.  */)
   (Lisp_Object object, Lisp_Object start, Lisp_Object end, Lisp_Object coding_system, Lisp_Object noerror)